home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1998 #4 / Amiga Plus CD - 1998 - No. 4.iso / pd / grafik / amifig3.0 / fig2dev.doc < prev    next >
Text File  |  1998-02-27  |  19KB  |  465 lines
  1. FIG2DEV(1)                                             FIG2DEV(1)
  2.  
  3.  
  4. NAME
  5.        fig2dev  -  translates  Fig  code to various graphics lan-
  6.        guages
  7.  
  8.  
  9. SYNOPSIS
  10.        fig2dev -L language [ -m mag ] [ -f font ] [ -s fsize ]  [
  11.        other options ] [ fig-file [ out-file ] ]
  12.  
  13.  
  14. DESCRIPTION
  15.        Fig2dev translates fig code in the named fig-file into the
  16.        specified graphics language and  puts  them  in  out-file.
  17.        The  default  fig-file and out-file are standard input and
  18.        standard output, respectively
  19.  
  20.        Fig (Facility for Interactive Generation of figures) is  a
  21.        screen-oriented  tool  which  allows  the user to draw and
  22.        manipulate objects interactively.  Various versions of Fig
  23.        run  under  the  Suntools/Sunview  window  environment and
  24.        under version 11 of the X Windows System.  Fig2dev is com-
  25.        patible with Fig versions 1.3, 1.4, 2.0, 2.1, 3.0, 3.1 and
  26.        3.2.
  27.  
  28.  
  29. OPTIONS
  30.        -L     Set the output graphics language.  Valid  languages
  31.               are  acad,  box, epic, eepic, eepicemu, gif, ibmgl,
  32.               jpeg, latex, mf (METAFONT), pcx, pic, pictex,  png,
  33.               ppm,  ps,  pstex,  pstex_t, textyl, tiff, tpic, xbm
  34.               and xpm.
  35.  
  36.               Note that dvips and xdvi must be compiled with  the
  37.               tpic  support  (-DTPIC) for epic, eepic and tpic to
  38.               work.
  39.  
  40.  
  41.        -m     Set the magnification at which the figure  is  ren-
  42.               dered to mag.  The default is 1.0.
  43.  
  44.        -f     Set the default font used for text objects to font.
  45.               The default is Roman; the  format  of  this  option
  46.               depends  on  the graphics language in use.  In TeX-
  47.               based languages, the font is the base of  the  name
  48.               given  in lfonts.tex, for instance "cmr" for Roman,
  49.               or "tt" for teletype.  In  PostScript,  it  is  any
  50.               font name known to the printer or interpreter.
  51.  
  52.        -s     Set  the  default  font  size  (in points) for text
  53.               objects to fsize.  The default is 11*mag, and  thus
  54.               is  scaled  by the -m option.  If there is no scal-
  55.               ing, the default font is eleven point Roman."
  56.  
  57.        -V     Print the program version number only.
  58.  
  59.        other options
  60.               The other options are specific  to  the  choice  of
  61.               graphics language, as described below.
  62.  
  63.  
  64. EPIC OPTIONS
  65.        EPIC  is  an enhancement to LaTeX picture drawing environ-
  66.        ment.  It was developed by Sunil Podar  of  Department  of
  67.        Computer Science in S.U.N.Y at Stony Brook.
  68.  
  69.        EEPIC  is  an  extension to EPIC and LaTeX picture drawing
  70.        environment which uses tpic specials as a graphics  mecha-
  71.        nism.   It  was written by Conrad Kwok of Division of Com-
  72.        puter Science at University of California, Davis.
  73.  
  74.        EEPIC-EMU is an EEPIC emulation package which does not use
  75.        tpic specials.
  76.  
  77.        -A     Scale  arrowheads  by factor.  The width and height
  78.               of arrowheads is divided by this factor.   This  is
  79.               because  EPIC  arrowheads are normally about double
  80.               the size of TeX arrowheads.
  81.  
  82.        -l     Use "\thicklines" when width of the line  is  wider
  83.               than lwidth.  The default is 2.
  84.  
  85.        -v     Include comments in the output file.
  86.  
  87.        -P     Generate a complete LaTeX file. In other words, the
  88.               output file can be formatted without requiring  any
  89.               changes. The additional text inserted in the begin-
  90.               ning and at the end of the file  is  controlled  by
  91.               the configuration parameter "Preamble" and "Postam-
  92.               ble".
  93.  
  94.        -S     Set the scale to  which  the  figure  is  rendered.
  95.               This  option  automatically  sets the magnification
  96.               and size to scale / 12 and scale respectively.
  97.  
  98.        -W     Enable variable line width.  By default,  only  two
  99.               line  widths  are  available: The normal line width
  100.               (hinlines), and thick lines (hicklines), if a  line
  101.               width of more than one is selected in xfig.
  102.  
  103.        -w     Disable  variable  line  width.  Only "\thicklines"
  104.               and/or "\thinlines" commands will be  generated  in
  105.               the output file.
  106.  
  107.        When  variable  line width option is enabled, "\thinlines"
  108.        command is  still  used  when  line  width  is  less  than
  109.        LineThick.  One  potential  problem  is  that the width of
  110.        "\thinlines" is 0.4pt but the resolution of  Fig  is  1/80
  111.        inch (approx. 1pt). If LineThick is set to 2, normal lines
  112.        will be drawn in 0.4pt wide lines but the next line  width
  113.        is  already 2pt. One possible solution is to set LineThick
  114.        to 1 and set the width of the those lines you want  to  be
  115.        drawn in "\thinlines"  to 0.
  116.  
  117.        Due  to  this  problem,  Variable  line  width VarWidth is
  118.        defaulted to be false.
  119.  
  120.  
  121. IBM-GL OPTIONS
  122.        IBM-GL (International Business Machines Graphics Language)
  123.        is  compatible  with  HP-GL (Hewlett-Packard Graphics Lan-
  124.        guage).
  125.  
  126.        -a     Select ISO A4 (ANSI A) paper size if the default is
  127.               ANSI A (ISO A4) paper size.
  128.  
  129.        -c     Generate instructions for an IBM 6180 Color Plotter
  130.               with (without) an  IBM  Graphics  Enhancement  Car-
  131.               tridge (IBM-GEC).
  132.  
  133.        -d     Restrict  plotting  to  a  rectangular  area of the
  134.               plotter paper which has a lower left hand corner at
  135.               (xll,yll)   and   a  upper  right  hand  corner  at
  136.               (xur,yur).  All four numbers are in inches and fol-
  137.               low -d in a comma-sparated list - xll,yll,xur,yur -
  138.               with no spaces between them.
  139.  
  140.        -f     Load text character specifications from  the  table
  141.               in  the fonts file.  The table must have 36 entries
  142.               - one for each font plus  a  default.   Each  entry
  143.               consists  of  5 numbers which specify the 1.) stan-
  144.               dard character set (0 - 4, 6 - 9,  30  -  39),  2.)
  145.               alternate  character  set  (0 - 4, 6 - 9, 30 - 39),
  146.               3.) character slant angle (degrees), 4.)  character
  147.               width  scale  factor and 5.) character height scale
  148.               factor.
  149.  
  150.        -l     Load area fill line patterns from the table in  the
  151.               patterns  file.   The  table must have 21 entries -
  152.               one for each of the area fill patterns.  Each entry
  153.               consists of 5 numbers which specify the 1.) pattern
  154.               number (-1 - 6), 2.) pattern length  (inches),  3.)
  155.               fill  type  (1  - 5), 4.) fill spacing (inches) and
  156.               5.) fill angle (degrees).
  157.  
  158.        -m     The magnification may appear as the  first  element
  159.               in  a  comma sepatated list - mag,x0,y0 - where the
  160.               second and third parameters specify  an  offset  in
  161.               inches.
  162.  
  163.        -p     Load  plotter  pen specifications from the table in
  164.               the pens file.  The table must have 9 entries - one
  165.               for each color plus a default.  Each entry consists
  166.               of 2 numbers which specify the 1.) pen number (1  -
  167.               8) and 2.) pen thickness (millimeters).
  168.  
  169.        -P     Rotate  the figure to portrait mode. The default is
  170.               landscape mode.
  171.  
  172.        -S     Set the pen speed to speed (centimeters/second).
  173.  
  174.        -v     Plot the figure upside-down  in  portrait  mode  or
  175.               backwards  in  landscape  mode.  This allows you to
  176.               write on the top surface of overhead transparencies
  177.               without  disturbing  the  plotter ink on the bottom
  178.               surface.
  179.  
  180.        Fig2dev may be installed with either  ANSI  A  or  ISO  A4
  181.        default  paper  size.  The -a option selects the alternate
  182.        paper size.  Fig2dev does not fill  closed  splines.   The
  183.        IBM-GEC  is  required to fill other polygons.  Fig2dev may
  184.        be installed for plotters with  or  without  the  IBM-GEC.
  185.        The -c option selects the alternate instruction set.
  186.  
  187.  
  188. LATEX OPTIONS
  189.        -l     Sets  the  threshold  between  LaTeX thin and thick
  190.               lines to lwidth pixels.  LaTeX  supports  only  two
  191.               different  line  width: \thinlines and \thicklines.
  192.               Lines of width greater than lwidth pixels are drawn
  193.               as  \thicklines.   Also affects the size of dots in
  194.               dotted line style.  The default is 1.
  195.  
  196.        -d     Set a separate magnification for the length of line
  197.               dashes to dmag.
  198.  
  199.        -v     Verbose mode.
  200.  
  201.        LaTeX cannot accurately represent all the graphics objects
  202.        which can be described by Fig.  For example, the  possible
  203.        slopes  which  lines  may have are limited.  Some objects,
  204.        such as spline curves, cannot be drawn at all.   Fig2latex
  205.        chooses  the closest possible line slope, and prints error
  206.        messages when objects cannot be drawn accurately
  207.  
  208.  
  209. PIC OPTIONS
  210.        -p     Enables the use of certain PIC extensions which are
  211.               known to work with the groff package; compatibility
  212.               with DWB PIC is unknown.  The extensions enabled by
  213.               each option are:
  214.  
  215.  
  216.        arc    Allow ARC_BOX i.e. use rounded corners
  217.  
  218.        line   Use the 'line_thickness' value
  219.  
  220.        fill   Allow ellipses to be filled
  221.  
  222.        all    Use all of the above
  223.  
  224.        psfont Don't convert Postscript fonts generic type (useful
  225.               for files going to be Ditroff'ed for and printed on
  226.               PS printer). DWB-compatible.
  227.  
  228.        allps  Use all of the above (i.e. "all" + "psfont")
  229.  
  230.  
  231. PICTEX OUTPUT
  232.        In order to include PiCTeX pictures into a document, it is
  233.        necessary to load the PiCTeX macros.
  234.  
  235.        PiCTeX uses TeX integer register  arithmetic  to  generate
  236.        curves,  and  so  it is very slow.  PiCTeX draws curves by
  237.        \put-ing the psymbol repeatedly, and so requires  a  large
  238.        amount  of  TeX's internal memory, and generates large DVI
  239.        files.  The size of TeX's memory limits the number of plot
  240.        symbols  in  a  picture.   As  a result, it is best to use
  241.        PiCTeX to generate small pictures.
  242.  
  243.  
  244. POSTSCRIPT OPTIONS
  245.        With PostScript, Fig can be used to create large  posters.
  246.        The  figure  will  be  created  by printing multiple pages
  247.        which can be glued together.  Simply specify the -M option
  248.        to produce a multi-page output.  Due to memory limitations
  249.        of most laser printers, the figure should not be too  com-
  250.        plicated. Great for text with very big letters.
  251.  
  252.        Text  can  now  include  various ISO-character codes above
  253.        0x7f, which is useful for language specific characters  to
  254.        be  printed  directly.   Not all ISO-characters are imple-
  255.        mented.
  256.  
  257.        Color support: Colored  objects  created  by  Fig  can  be
  258.        printed  on a color postscript printer. There are 32 stan-
  259.        dard colors: black, yellow, white, gold,  five  shades  of
  260.        blue,  four  shades  of  green,  four shades of cyan, four
  261.        shades of red, five shades  of  magenta,  four  shades  of
  262.        brown,  and four shades of pink.  In addition there may be
  263.        user-defined colors in the file.  See the  xfig  FORMAT3.2
  264.        file  for the definition of these colors.  On a monochrome
  265.        printer, colored objects will  be  mapped  into  different
  266.        grayscales  by  the  printer.   Filled objects are printed
  267.        using the  given  area  fill  and  color.   There  are  21
  268.        "shades"  going  from black to full saturation of the fill
  269.        color, and 21 more "tints" from full  saturation  +  1  to
  270.        white.  In addition, there are 16 patterns such as bricks,
  271.        diagonal lines, crosshatch, etc.
  272.  
  273.        -c     option centers the figure on the page.  The center-
  274.               ing  may  not be accurate if there are texts in the
  275.               fig_file that extends too far to the right of other
  276.               objects.
  277.  
  278.        -e     option  puts  the figure against the edge (not cen-
  279.               tered) of the page.
  280.  
  281.        -l dummy_arg
  282.               Generate figure in landscape mode.  The dummy argu-
  283.               ment  is  ignored,  but  must appear on the command
  284.               line for reasons  of  compatibility.   This  option
  285.               will  override the orientation specification in the
  286.               file (for file versions 3.0 and higher).
  287.               This option is only honored when not using  the  -P
  288.               option  (add showpage).  This is because the figure
  289.               doesn't need to be rotated when generating Encapsu-
  290.               lated PostScript (EPS).
  291.  
  292.        -M     Generate  multiple  pages  if  figure exceeds paper
  293.               size.
  294.  
  295.        -p dummy_arg
  296.               Generate figure in portrait mode.  The dummy  argu-
  297.               ment  is  ignored,  but  must appear on the command
  298.               line for reasons  of  compatibility.   This  option
  299.               will  override the orientation specification in the
  300.               file (for file versions 3.0 and higher).   This  is
  301.               the  default for Fig files of version 2.1 or lower.
  302.  
  303.        -P     indicates that the figure  describes  a  full  page
  304.               which will not necessarily be inserted into a docu-
  305.               ment, but can be sent directly  to  a  PS  printer.
  306.               This ensures that a showpage command is inserted at
  307.               the end of the figure.
  308.  
  309.        -n name
  310.               Set the Title part  of  the  PostScript  output  to
  311.               name.   This  is  useful  when the input to fig2dev
  312.               comes from standard input.
  313.  
  314.        -x offset
  315.               shift the figure in the X direction by offset units
  316.               (1/72 inch).  A negative value shifts the figure to
  317.               the left and a positive value to the right.
  318.  
  319.        -y offset
  320.               shift the figure in the Y direction by offset units
  321.               (1/72 inch).  A negative value shifts the figure up
  322.               and a positive value down.
  323.  
  324.        -z papersize
  325.               Sets the papersize. Available paper sizes are:
  326.                   "Letter" (8.5" x 11" also "A"),
  327.                   "Legal" (11" x 14" also "A")
  328.                   "Ledger" (11" x 17"),
  329.                   "Tabloid" (17" x 11", really Ledger in Landscape mode),
  330.                   "A" (8.5" x 11" also "Letter"),
  331.                   "B" (11" x 17" also "Ledger"),
  332.                   "C" (17" x 22"),
  333.                   "D" (22" x 34"),
  334.                   "E" (34" x 44"),
  335.                   "A4" (21  cm x  29.7cm),
  336.                   "A3" (29.7cm x  42  cm),
  337.                   "A2" (42  cm x  59.4cm),
  338.                   "A1" (59.4cm x  84.1cm),
  339.                   "A0" (84.1cm x 118.9cm),
  340.                   and "B5" (18.2cm x 25.7cm).
  341.  
  342.  
  343.  
  344. PSTEX OPTIONS
  345.        The    pstex language is a variant of ps which  suppresses
  346.               formatted (special) text.  The pstex_t language has
  347.               the complementary behavior: it generates only LaTeX
  348.               commands necessary to position special text, and to
  349.               overlay the PostScript file generated using  pstex.
  350.               These  two drivers can be used to generate a figure
  351.               which combines the flexibility of PostScript graph-
  352.               ics with LaTeX text formatting of special text.
  353.  
  354.        The    pstex  option  -n  name  sets the Title part of the
  355.               PostScript output to name.  This is useful when the
  356.               input to fig2dev comes from standard input.
  357.  
  358.        The    pstex_t  option  -p  file specifies the name of the
  359.               PostScript file to be overlaid.  If not set or  its
  360.               value is null then no PS file will be inserted.
  361.  
  362.  
  363.  
  364. TEXTYL OPTIONS
  365.        There are no TeXtyl-specific options.
  366.  
  367.  
  368. METAFONT OPTIONS
  369.        -C code
  370.               specifies the starting METAFONT font code.
  371.  
  372.        -n name
  373.               specifies the name to use in the output file.
  374.  
  375.        -p pen specifies the size of the METAFONT pen.
  376.  
  377.        -t top specifies the top of the whole coordinate system.
  378.  
  379.        -x xneg
  380.               specifies  the  minimum  x  coordinate value of the
  381.               figure (inches).
  382.  
  383.        -y yneg
  384.               specifies the minumum y  coordinate  value  of  the
  385.               figure (inches).
  386.  
  387.        -X xpos
  388.               specifies  the  maximum  x  coordinate value of the
  389.               figure (inches).
  390.  
  391.        -Y ypos
  392.               specifies the maximum y  coordinate  value  of  the
  393.               figure (inches).
  394.  
  395.  
  396.  
  397. TPIC OPTIONS
  398.        There are no tpic-specific options.
  399.  
  400.  
  401. SEE ALSO
  402.        [x]fig(1), pic(1) pic2fig(1), transfig(1)
  403.  
  404. COPYRIGHT
  405.        Copyright (c) 1985 Supoj Sutantavibul
  406.        Copyright (c) 1991 Micah Beck
  407.  
  408.        Permission to use, copy, modify, distribute, and sell this
  409.        software and its documentation for any purpose  is  hereby
  410.        granted  without  fee,  provided  that the above copyright
  411.        notice appear in all copies and that both  that  copyright
  412.        notice  and  this  permission  notice appear in supporting
  413.        documentation. The authors make no  representations  about
  414.        the  suitability  of this software for any purpose.  It is
  415.        provided "as is" without express or implied warranty.
  416.  
  417.        THE AUTHORS DISCLAIM ALL WARRANTIES WITH  REGARD  TO  THIS
  418.        SOFTWARE,   INCLUDING   ALL  IMPLIED  WARRANTIES  OF  MER-
  419.        CHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE
  420.        LIABLE  FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES
  421.        OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
  422.        OR  PROFITS,  WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  423.        OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN  CONNECTION
  424.        WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  425.  
  426. AUTHORS
  427.        Micah Beck
  428.        Cornell University
  429.        Sept 28 1990
  430.  
  431.        and Frank Schmuck (then of Cornell University)
  432.        and Conrad Kwok (then of U.C. Davis).
  433.  
  434.        drivers contributed by
  435.        Jose Alberto Fernandez R. (U. of Maryland)
  436.        and Gary Beihl (MCC)
  437.  
  438.        Color  support,  ISO-character encoding and poster support
  439.        by
  440.        Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
  441.  
  442.        Modified from f2p (fig to PIC), by the author of Fig
  443.        Supoj Sutanthavibul (supoj@sally.utexas.edu)
  444.        University of Texas at Austin.
  445.  
  446.        MetaFont driver by
  447.        Anthony Starks (ajs@merck.com)
  448.  
  449.        X-splines code by
  450.        Carole Blanc (blanc@labri.u-bordeaux.fr)
  451.        Christophe Schlick (schlick@labri.u-bordeaux.fr)
  452.        The initial implementation was  done  by  C.  Feuille,  S.
  453.        Grobois,  L.  Maziere and L. Minihot as a student practice
  454.        (Universite Bordeaux, France).
  455.  
  456.        MetaFont driver by
  457.        Anthony Starks (ajs@merck.com)
  458.  
  459.        X-splines code by
  460.        Carole Blanc (blanc@labri.u-bordeaux.fr)
  461.        Christophe Schlick (schlick@labri.u-bordeaux.fr)
  462.        The initial implementation was  done  by  C.  Feuille,  S.
  463.        Grobois,  L.  Maziere and L. Minihot as a student practice
  464.        (Universite Bordeaux, France).
  465.